.. _ecmSxSt_IsConnected:

ecmSxSt_IsConnected
==========================
--------------------------


SYNOPSIS
--------


.. code-block:: none

  t_bool ecmSxSt_IsConnected(
    t_i32  NetID,
    t_i32  Axis,
    EEcmConnStsDetail  *ConnStsDetail,
    t_i32  *ErrCode
  )



DESCRIPTION
-----------


- 지정한 축의 연결상태를 반환하는 함수입니다.
 



PARAMETER
---------


- NetID : Network 번호

- Axis : 대상 축 번호

- :ref:`ConnStsDetail  <ecat_enum_EEcmConnStsDetail>`  : 해당 축의 연결 상태에 대한 상세 정보를 반환 받을 포인터. 이 포인터를 통해서 반환 받은 값의 의미는 다음과 같습니다.

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
------------


- 해당 축이 연결되어 있는지 여부를 반환합니다.


+-------+------------------------------+
| Value | Meaning                      |
+=======+==============================+
| 0     | 해당 축이 연결되어 있지 않음 |
+-------+------------------------------+
| 1     | 해당 축이 연결되어 있음      |
+-------+------------------------------+



EXAMPLE
`````````````

.. code-block:: cpp
 :linenos:


  EEcmConnStsDetail ConnStsDetail;
  t_bool IsConnected = ecmSxSt_IsConnected(NETID, Axis, &ConnStsDetail, NULL);

  // IsConnected는 연결되었는지 안되었는지에 대한 상태를 true/false로 반환하는데, ConnStsDetail변수를 참조하면 좀더 자세하게 연결상태를 알아볼수 있다.
  if(ConnStsDetail == ecmCONN_STS_NOCONFIG){
        GetDlgItem(IDC_edtAlStateMon)->SetWindowText(_T("Invalid Axis"));
        return CDialog::OnTimer(nIDEvent);
  }
  else if(ConnStsDetail == ecmCONN_STS_DISCONN){
        GetDlgItem(IDC_edtAlStateMon)->SetWindowText(_T("Disconnected"));
        return CDialog::OnTimer(nIDEvent);
  }
  else{
        TCHAR szTemp[128];
        GetAlStateText(ConnStsDetail, szTemp, 50);
        GetDlgItem(IDC_edtAlStateMon)->SetWindowText(szTemp);
 }